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Section 7C 
Z80 EMULATOR SPECIFICS 


INTRODUCTION 


This section supports the Z80A Emulator Processor and Prototype Control Probe as well as the newer Z80B 
Emuiator Processor and Probe. While the Z80A Emulator Processor can emulate only Z80 and Z80A 
microprocessors, the Z80B Emulator Processor can emulate the Z80, Z80A, and Z80B microprocessors. 


In this section, the term “Z80 emulator’ is used in presenting information that applies to both the older Z80A 
emulator and the newer Z80B emulator. The term “Z80A emulator” is used for information that applies only 
to the Z80A Emulator Processor. The term “Z80B emulator” is used for information that applies only to the 
newer Z80B Emulator Processor. 


This Emulator Specifics section is to be inserted into Section 7 of the 8550 System Users Manual (DOS/50 
Version 2) or the 8540 System Users Manual. It explains the features of the 8550 and 8540 systems that are 
unique to the Z80A and Z80B Emulators. Throughout the section, “your System Users Manual’ refers to the 
8550 System Users Manual or 8540 System Users Manual. The Z80 Demonstration Run is designed to be 
used with Section 1 (the Learning Guide) of your System Users Manual; the rest of this section contains 
reference material. 


GENERAL INFORMATION | 


Emulator Hardware Configuration 


Throughout this Emulator Specifics section, the term *Z80 emulator” refers to a Z80 Emulator Processor 
boad configured with a Z80 Prototype Control Probe or mobile microprocessor. In emulation Mode 0, the 
mobile microprocessor may be inserted directly into the emulator board. In Modes 1 and 2, the mobile 
microprocessor must be installed in the prototype control probe and the prototype control probe must be 
connected to both the emulator and your prototype. For instruction on installing the emulator board, mobile 
microprocessor, and probe, refer to the Z80 Emulator Processor and Prototype Control Probe Installation 
Service Manual. 


Microprocessors Supported 

The Z80A emulator emulates the Zilog, Z80 and Z80A microprocessors. The Z80B emulator emulates the 
Zilog 280, Z80A, and Z80B microprocessors. 

Emulation Modes 


The Z80 emulator supports Emulation Modes 0, 1, and 2, as described in the Emulation section of your 
System Users Manual. The Z80 emulator supports service calls (SVCs) in all three modes. 
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7C-2 


Z80A Clock Rate 


in Mode 0 emulation, the emuiator clock rate is 2 or 4 MHz, depending on the setting of jumper J1. In Mode 
1 emulation, the maximum recommended rate for the prototype clock is 4 MHz. 


Z80B Clock Rate 


In Mode 0 emulation, the emulator clock rate is 4 or 6 MHz, depending on the setting of jumper J3002. In 
Mode 1 emulation, the clock rate of 6 MHz may be used only with 8500-series systems. At this 6 MHz rate, 
one wait state will be inserted. 


NOTE 


When used with the Trigger-Trace Analyzer (TTA) or the Real-Time Prototype Analyzer (RTPA), the 
2808 Emulator Processor provides an output that is one-half of the emulator operating clock rate. 
Therefore, the clock count stored in the TTA or RTPA buffers will be one-half of the actual emulator 
clock count. 


Symbolic Debug 


The Z80 emulator supports the use of symbolic debug. 


EMULATOR-SPECIFIC COMMANDS, PARAMETERS, AND 
DISPLAYS 


SEL—Selecting an Emulator 


The SEL (SELect) command allows you to select the emulator you want to use with your system. The 
following command line selects the Z80 emulator and assembler: 
> SEL 280 


Byte/Word Parameter 


Several commands offer you the choice of operating on memory on a byte-oriented or word-oriented basis. 
In affected commands, this choice is represented by the —B or —W parameter. For the Z80 emulator, the 
default value is —B (Byte). 


MAP—Mapping Memory 


The Z80 addresses a 64 K memory space, arranged in 512 blocks of 128 bytes each. The MAP command 
enables you to assign blocks of memory to either program memory or prototype memory, and to designate 
blocks of program memory as read-only. Refer to the Command Dictionary for details on the syntax, param- 
eters, and use of the MAP command. 
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Setting Breakpoints 


The Z80 emulator allows you to specify up to two breakpoints with the BK command. 


Memory Allocation Commands 

The Memory Allocation Controller (MAC) option cannot be used with the Z80 emulator. The Z80 does not 
use the MEMSP command, and does not support memory space qualifiers or expressions. The Z80 emula- 
tor supports the AL (ALlocate) command, as described in the Command Dictionary of your System Users 
Manual. The DEAL, MEM, and NOMEM commands are not supported. 

Port Commands 


The Z80 emulator does not support the RD or WRT commands. 


CONS Command Modes 


The Z80 emulator supports the FET mode of the CONS command of the Trigger Trace Analyzer. The Z80 
does not support the EMU mode of the CONS command. 


Register Designators 


Table 7C-1 alphabetically lists the symbols used by DOS/50 and OS/40 to designate the registers and flags 
used by the Z80. The table provides the following information for each symbol: 


® adescription of the register or flag that the symbol represents; 
e the size of the register or flag; 
e the value assigned to the register or flag by the RESET command; 


e whether the register or flag can be assigned a value by the S (Set) command. 


Figure 7C-1 shows the contents of the Z80 flag register. 
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Table 7C-1 


Z80 Registers and Flags 


Description 


Register A 

Alternate register A 
Alternate register B 
Alternate registers B & C 
Alternate register C 
Alternate register D 
Alternate registers D & E 
Alternate register E 
Alternate flag register 
Alternate register H 
Alternate registers H & L 
Alternate register L 
Register B 

Registers B & C 
Register C 

Carry flag ° 

Register D 

Registers D&E 
Register E 

Flag register ° 

Register H 

Auxiliary carry flag ° 
Registers H &L 
Interrupt page address register 
Interrupt flip-flop 1 
Interrupt flip-flop 2 
Interrupt mode 

Index register X 

Index register Y 

Register L 

Subtract flag ° 

Overflow flag ° 

Parity flag ° 

Program counter 
Memory refresh register 
Sign flag ° 

Stack pointer 

Zero flag” 


3 NC = not changed by RESET 
> The flag register is illustrated in Fig. 7C-1. 


° The S command performed on either IFF1 or IFF2 sets both. 


Size in 
Bits 


—_h oh woh, woh, os 
DPA DW WHMDMMDHWDMDAMSMW DH OW |g © ® OW 


— © © © 


— 
oO) 


hk 
"~=—-:}%OGQDoO7 7 -@ 
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Value After Alterable 
RESET? 


by S 
Command? 


yes 
yes 
yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
00 yes 

0 yes ° 

0 yes ° 
0 yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
NC yes 
0000 no 
yes 
yes 
yes 
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carry bit = 1 if carry 


subtract bit = 1 if subtract 


parity/overflow bit = 1 if even 
parity or overflow condition 


not used 


auxiliary-carry bit = 1 
if auxiliary-carry 


not used 
zero bit = 1 if zero 


sign bit = 1 if negative 


Fig. 7C-1. Flag register bit configuration in the Z80 emulator. 


BUS and EVE—Bus Operation Designators 


Table 7C-2 lists the Z80 bus operation designators recognized by the Trigger Trace Analyzer’s BUS com- 
mand, and for the B parameter of the EVE command. 


Table 7C-2 
Z80 Bus Operation Designators 


Bus Operation Type 


CLR All types 

F Instruction Fetches 
NF Non-fetches 

M Memory accesses 
RD Reads 

WT Writes 


| I/O operations 
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DS—Sample Z80 Emulator Status Display 


The DS (Display Status) command displays the status and register contents of the Z80. All numbers in the 
DS display line are hexadecimal. 


Here is an example of a DS display line for the Z80 emulator: 


> DS 
PC=0000 SP=5645 F=43 A=C3 B=02 c=04 D=04 E=24 H=01 L=32 
IX=1111 lY=2222 AF=00 AA=00 AB=20 AC=30 AD=40 AE=50 AH=60 AL=70 


IFF1=0 IFF2=0 IM=O I=00 R=00 


Table 7C-1 explains the symbols displayed by the DS command. 


For the Z80 emulator, the short and long forms of the DS display are the same: DS gives the same display 
as DS -L. 


RESET—Resetting Z80 Emulator Status 


The RESET command produces a hardware reset signal to the Z80 microprocessor. The Z80 registers are 
reset to the values indicated in Table 7C-1. 


Example. Suppose the DS command returns the following emulation status: 


> Ds 
PC=0100 SP=5645 F=43 A=C3 B=02 C=04 D=04 E=24 H=01 L=32 
IX=1111 1Y=2222 AF=00 AA=00 AB=20 AC=30 AD=40 AE=50 AH=60 AL=70 


IFFl=1 IFF2=1 IM=1 I=01 R=01 


Enter the RESET command. Then check the status again with the DS command: 


> RESET 

> Ds 

PC=0000 SP=5645 F=43 A=C3 B=02 C=04 D=04 E=24 H=01 L=32 
IX=1111 IY=2222 AF=00 AA=00 AB=20 AC=30 AD=40 AE=50 AH=60 AL=70 


IFF1=0 IFF2=0 IM=0 I=00 R=00 


r ft 7 ft 4 


The arrows show the changed registers. 
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Di—Sample Z80 Disassembled Code 


The DI (Disassemble) command translates object code in memory into assembly language instructions. DI 
displays object code, assembly language mnemonics, and operands. Use the DI command to verify that the 
values in memory correspond to the assembly language instructions of your program. 


Here is an example of Z80 DI command output: 
> DI 100 10E 
LOC INST MNEM OPER 
000100 210005 LD HL, 0500 
000103 0605 LD B,O5 


000105 AF XOR A 
000106 86 ADD A, (HL) 
000107 23 INC HL 
000108 05 DEC B 
000109 c20601 JP NZ,0106 
00010C D3F7 OUT (F7),A 
OOO10E 00 NOP 


------ operand (s): address, register, or data 
being operated on 


machine language instruction 


‘Sapa SSS eS er Se eee address of the instruction 


TRA—Sample Z80 TRAce Display 


The TRA (TRAce) command selects the range and type of instructions to be displayed as your program 
executes. With the Z80 emulator, the TRA -N format is the same as the TRA -L format. 


NOTE 


When TRAce conditions have been set, the emulator runs at slower than normal processing speeds 
and RTPA breakpoints are suppressed. 
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Here is an example of Z80 TRA command output: 


> TRA ALL 
> G 100 
LOC INST MNEM OPER SP F A B CC D E Hi OL 1X IY 
000100 210005 ILD HL,0500 0000 06 OF O1 00 00 00 O05 OO oC00 >CCCC 
000103 0605 LD B,O5 0000 06 OF 05 00 00 00 05 00 0000 0000 
000105 AF XOR A 0000 46 00 O05 00 00 00 05 00 0000 0000 
000106 86 ADD A,(HL) 0000 02 O01 05 00 00 00 05 00 0000 0000 
000107 23 INC HL 0000 02 01 05 00 00 O00 05 01 0000 0000 
000108 05 DEC B 0000 12 O01 04 00 00 00 05 O01 0000 0000 
000109 cC20601 JP NZ,0106 0000 12 01 04 00 00 00 05 O1 0000 0000 
000106 86 ADD A,(HL) 0000 06 03 04 00 00 00 05 01 0000 0000 
000107 23 INC HL 0000 06 03 04 00 00 00 O05 O02 0000 0000 
000108 05 DEC B 0000 16 03 03 00 00 00 05 O02 0000 0000 
000109 cC20601 JP NZ,0106 0000 16 03 03 00 00 00 05 O02 0000 0000 
. MW I 
ce i a an ce rc a | 
{ 1 I | I I } I 1 I ! I 1 1 ! 
BO Ah AY A il 
foo a i ne Oe a a 
i po of fF 4 Pt : ! register 
i | ee re | Y 
a oe ee ie Ge ea oe 
1 u t { j 
i P 4 re ee ee d 
| re ae oe Or cee ee index 
i pb obo ad H i register 
t | i ; { u 1 : ‘ I I | ' x 
i 1 i ! i H H : 
l i i 1 ij } I I H } 1 1 \ 
I I 1 | I I T | t I 1 1 1 
: I i H ' i i] fl t ! ’ 1 
i ! ' ' A B Cc D CE H L 
1 “ 
| : contents of registers 
I 1 
4 i | 
1 r 
: '~-- flag register contents 
oe | 
anna stack pointer contents 
( 
a ae 
1 i z 
Inenna-------------- operand of the instruction 
1 
. 4 ! 
| : Fi . 
i aaa in ne en mnemonic of the instruction 
H 1 
SSeS necke ror ase aes ee aoe machine language instruction 
J 


Sp eee gg nee ee ween pe eee aye et ee go eee address of the instruction 
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SERVICE CALLS 


Service calls (SVCs) enable your program to use many system capabilities of your 8540, 8550, or 8560. 


An SVC is invoked with a Z80 OUT instruction. The operand of the OUT instruction directs the system to a 
specified memory address called the SRB pointer (which points to the SRB—the Service Request Block). 
The SRB pointer tells the system where to find the data (stored in the SRB) that informs the system which 
function to perform. Refer to the Service Calls section of your System Users Manual for an explanation of 
service calls, service request blocks, and SRB pointers. 


Your program can point to eight SRBs at any one time. As your program executes, it can store new 
addresses in the SRB vector. Table 7C-3 shows the default addresses for the eight SRB pointers. These 
addresses and their associated port numbers can be altered with the SVC command to suit your program 
requirements. See the Command Dictionary section of your System Users Manual for syntax and use of the 
SVC command. 


SVCs in Modes 1 and 2 
The Z80 emulator supports SVCs in Emulation Modes 1 and 2, as described in the Service Calls section of 


your System Users Manual. In Mode 2, all parts of the SVC must reside in prototype memory. 


NOTE 


In Mode 0 and 1, use one NOP instruction immediately following the OUT instruction. In Mode 2, use 
two NOP instructions immediately following the OUT instruction; this allows time for the SVC to occur. 


SRB Format 


The Z80 emulator uses the SAS (Small Address Space) format for SRBs and the SRB vector. This format is 
described in the Service Calls section of your System Users Manual. 


SVC Demonstration 


Figure 7C-2 lists a Z80 program that uses four SVC functions: Assign Channel, Read ASCII, Write ASCII, 
and Abort. The program’s algorithm is explained in the Service Calls section of your System Users Manual, 
which demonstrates a version of the program written in 8085A assembly language. You can perform a 
parallel demonstration with the Z80 emulator and Z80 A Series Assembler using the program in Fig. 7C-2. 
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Table 7C-3 
280 Service Calls 


Z80 Service Calls Default Address of 
SVC Number mnemonic® hexadecimal SRB pointer 
1 OUT (0F7H),A NOP D3F7 00 40, 41 


OUT (OF6H),A NOP D3F6 00 42, 43 
OUT (OF5H),A NOP D3F5 00 44, 45 
OUT (OF4H),A NOP D3F4 00 46, 47 
OUT (OF3H),A NOP D3F3 00 48, 49 
OUT (OF2H),A NOP D3F2 00 4A, 4B 
OUT (0F1H),A NOP D3F1 00 4C, 4D 
OUT (OFOH),A NOP D3F0 00 4E, 4F 


COPrn  _ oy]oape | ®] M 


*You can use an IN instruction (opcode DB) in place of each OUT instruction given in Table 7C-3. 


NOTE 


The program shown in Fig. 7C-2 is written for an A Series assembler (as provided for the 8550). To 
make this acceptable for a B Series assembler (as provided for the 8560), change each double quote 
(’) to a single quote ('). This program shows the use of four service calls. The program's algorithm is 
explained in the Service Calls section of your System Users Manual. The program accepts a line of 
ASCII characters from the system terminal; then, when it receives a RETURN character, the program 
writes the line to the line printer and accepts another line. (On the 8550, output to the line printer is 
buffered. No text is printed until the line printer buffer in the 8501 becomes full or the program ends.) 
To terminate the program, enter a CTRL-Z while the program is waiting for input. 
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Service Calls 


SSSS 
S 
SSSS 


SSSS 


woe we we we we 


; 
SRBIFN 


DR BIST 


SRB2FN 


SRB2ST 


SRB3FN 


SRBSST 


; 
’ 
SRB4FN 


SRB4ST 


Ss Vv V ccccc 
V Vc 
me NE 3-0 DEMONSTRATION. Z80 EMULATOR 
ow YY 
S V Cccce 
ORG 40H ; BEGINNING OF SRB VECTOR 


BYTE HI (SRB1FN),LO(SRBIFN) 
BYTE HI (SRB2FN),LO(SRB2FN) 
BYTE HI (SRB3FN),LO(SRB3FN) 
BYTE HI(SRB4FN),LO(SRB4FN) 
BYTE HI (SRB5FN),LO(SRB5SFN) 
END OF SRB VECTOR 


ORG 100H ; SET UP SRB AREAS 

SRB1 = ASSIGN "CONI" TO CHANNEL O 

BYTE 1 OH ; ASSIGN 

BYTE OOH ; TO CHANNEL O 

BLOCK O1H ; STATUS RETURNED HERE 
BLOCK 02H ; BYTES 4 AND 5 NOT USED 
BYTE O5H ; LENGTH OF "CONI"+<CR> 
BYTE HI (CONI ) ; POINTER TO 

BYTE LO(CONI ) ; "CONI"+<CR> 

END OF SRB1 

SRB2 = ASSIGN "LPT" TO CHANNEL 1 

BYTE 1 OH ; ASSIGN 

BYTE O1H ; TO CHANNEL 1 

BLOCK O1H ; STATUS RETURNED HERE 
BLOCK O2H ; BYTES 4 AND 5 NOT USED 
BYTE O4H ; LENGTH OF "LPT"+<CR> 
BYTE HI (LPT ) ; POINTER TO 

BYTE LO (LPT ) ; "LPT"+<CR> 


END OF SRB2 


SRB3 = READ ASCII LINE FROM CONI (CHANNEL 0) 


BYTE O1H ; READ ASCII 

BYTE OOH ; FROM CHANNEL O 

BLOCK O1H ; STATUS RETURNED HERE 
BLOCK O1H ; BYTE 4 NOT USED 

BLOCK O1H ; BYTE COUNT RETURNED HERE 
BYTE OOH ; 256 BYTES IN OUR BUFFER 
BYTE HI (BUFFER ) ; POINTER TO 

BYTE LO (BUFFER ) ; OUR BUFFER 

END OF SRB3 

SRB4 = WRITE ASCII LINE TO LPT (CHANNEL 1) 

BYTE 02H ; WRITE ASCII 

BYTE O1H > TO CHANNEL 1 

BLOCK O1H ; STATUS RETURNED HERE 
BLOCK O1H ; BYTE 4 NOT USED 

BLOCK O1H ; BYTE COUNT RETURNED HERE 
BYTE OOH ; 256 BYTES IN OUR BUFFER 
BYTE HI (BUFFER ) ; POINTER TO 

BYTE LO (BUFFER ) ; OUR BUFFER 


END OF SRB4 
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; SRB5 = ABORT (CLOSE ALL CHANNELS AND TERMINATE) 
SRB5FN BYTE 1 FH ; ABORT 

BLOCK O7H ; BYTES 2 THROUGH 8 NOT USED 
; END OF SRB5 


BUFFER BLOCK 1 00H ; OUR I/O AREA 
CONI KSC. "CONI" ; ASCII OF "CONI" 
BYTE ODH ; + <CR> 
NSC It “UPD * ASCII OF "LPT" 

BYTE ODH ; + <CR> 
END OF DATA DEFINITIONS 


BEGINNING OF EXECUTABLE CODE 
ORG 1000H ; ENTRY POINT INTO PROGRAM 
OUT (OF7H),A * CALL SVC1 
NOP > TO ASSIGN "CONI" 
LD A, (SRBIST) CHECK THE STATUS TO SEE 
CP OOH IF ALL WENT WELL 
JP NZ, ABORT NO? STOP EVERYTHING 
OUT (OF6H),A YES? CALL SVC2 
NOP TO ASSIGN "LPT" 
LD A, (SRB2ST) CHECK THE STATUS TO SEE 
CP OOH IF ALL WENT WELL 
JP NZ,ABOR NO? STOP EVERYTHING 
(OF5H), CALI: SVCS 
TO READ A "CONI" LINE 
A,(SRB3ST) ; INTO "BUFFER" 
OOH >; ALL OK? 
NZ, ABORT ; NO? STOP EVERYTHING 
(OF4H),A ; CALL SVC4 
; TO WRITE TO "LPT" 
A, (SRB4ST) ; CHECK TO SEE IF 
OOH - ALL IS OK 
Z,, LOOP ; YES? BACK TO READ ANOTHER LINE 
NO? FALL THROUGH TO TERMINATION 
(OF 3H),A - CALL SVC5 
; TO DO THE ABORT 
SHOULD NEVER REACH HERE 


T 
A 


we we we we we we we we we we 


START 


Fig. 7C-2. Z80 SVC demonstration program listing (part 2 of 2). 
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Z80 SPECIAL CONSIDERATIONS 

The Z80 emulator behaves like the Z80 microprocessor, with the following exceptions 
e Interrupts are detected only when user code is being executed. 

¢ When TRAce is enabled, there is a maximum 153 ns delay on the IORQ signal. 


© During TRAce sequences, the emulator performs the auxiliary memory refresh operations between exe- 
cution of user code instructions. 


Z80A JUMPERS 


Z80A Emulator Board 


The Z80A Emulator board contains two jumpers, J1 and J3. Jumper J1 selects between 2 MHz and 4 MHz 
as the system clock speed for Emulation Mode 0. Jumper J3 is used to delete wait states in Emulation Mode 
1. 


Z80A Driver/Receiver Board 


The Z80A Driver/Receiver contains two jumpers, J1041 and J3051. In Emulation Mode 1, MREQ is unavail- 
able to the prototype when jumper J1041 is in the right-most position. When J1041 is in the left-most 
position, MREQ is available to the prototype whenever HOLDA is not asserted. 


When jumper J3051 is in the right-most position, data fetched from program memory (in Mode 1) does not 
appear at the probe tip. When jumper J3051 is in the left-most position, data from program memory is driven 
to the prototype. If jumper J3051 is in the left-most position, jumper J1041 must also be in the left-most 
position. 


NOTE 


With jumper J3051 in the left-most position, prototype bus contentions may occur. 


Both jumpers J1041 and J3051 are shipped in the right-most position. 
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Z80B JUMPERS 


Z80B Emulator Board 


The Z80B emulator board contains four jumpers: J3003, J1059, J1061, and J1081. 


Jumper J3003 selects a clock speed of either 4 MHz or 6 MHz for Emulation Mode 0. A clock speed of 
6 MHz must not be used with a 8002A system. J1059 is placed in the normal position when the Z80B 
processor is in interrupt modes 1 and 2 or mode 0 single-byte vectors. 


J1059 is placed in the IM 0 MULTI position when the processor is in interrupt Mode 0 and there is a 
possibility of multi-byte instruction vectors. In this position, the interrupt data is gated in from the probe tip 
by the INTA line, which is asserted and disabled by the stack write associated with the interrupt or the next 
fetch. The INTA line is asserted during a maskable interrupt shortly after MI and IOREQ are asserted by the 
emulator processor. In Emulation Mode 1, and with the stack pointer mapped to program memory, it is 
possible to get an additional short MEMREQ pulse at the probe tip during the first part of the stack write. 


J1061 controls the number of wait states. (The function selected with J1061 may interact with the function 
selected by J1082. See the discussion, “4 MHz and Below’, later in this section.) J1061 has three positions: 


¢ The WAITS position selects no wait state and should be used only with 8540 and 8550 systems at 
4 MHz and below. 


® The 85XX position selects one wait state and should be used only with 8540 or 8550 systems. 


*® The 800X position selects two wait states and should be used only with 8001 or 8002A systems. 


J1081 controls the modes of operation under which wait states are inserted. The positions required for 
various configurations of the systems are described in the following text. 


8001/8002A Systems Jumper Considerations 


¢ When J1081 is in the SLOW position, J1061 shouid be in the 800X position and J3003 should be in the 
4 MHz position. 


¢ Two wait states are inserted each time the program memory is accessed, or when running in emulation 
Mode 1. 


¢ No wait states are inserted in Mode 2 except when operating in debug mode, or memswitch mode during 
the jump sequence. Two wait states are inserted in these modes. 
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8500-Series Systems Jumper Considerations 


© 4 MHz and Below. With J1081 placed in the SLOW position and J1061 placed in the WAITS position, no 
wait states are inserted in Emulation Modes 90, 1, or 2. One wait state is inserted during a forced jump 
sequence. 


¢ 4MdHz to 6 MHz. When operating between 4 and 6 MHz, the following wait states may be selected 


(J1061 in 85XX position). (If operating is Emulation Mode 1 and all memory is mapped to program 
memory, J1061 can be placed in WAITS position with no wait states in Modes 0, 1, or 2.) 


NOTE 


You can generate additional wait states in Emulation Mode 1 or 2 when memory is mapped to the 
prototype. 
1. J1081 in SLOW Position (used with 670-6542-00 and up memory boards). 
a. One wait state inserted in Emulation Modes 0 and 1. 
b. No wait states inserted in Emulation Mode 2 except during memswitch and forced jump operations 
when one wait state is inserted. 
2. J1081 in FAST Position (not used with 670-6542-00 and up memory boards). 
a. No wait states inserted in Emulation Modes 0 and 2. 


b. One wait state is added during forced jump, memswitch operations, and Mode 1. 


Z80B Driver/Receiver Board 
The Z80B Driver/Receiver contains two jumpers: J1041 and J3051. When memory is mapped to the system 


in Emulation Mode 1, MREQ is unavailable to the prototype when J1041 is in the right-most position. When 
J1041 is in the left-most position, MREQ is available to the prototype whenever HOLDA is not asserted. 


When jumper J3051 is in the right-most position, data fetched from program memory (Mode 1 only) does not 
appear at the probe tip. When J3051 is in the left-most position, data from program memory is driven to the 
prototype. If jumper J3051 is in the left-hand position, jumper J1041 must also be in the left-most position. 


NOTE 


With jumper J3051 in the left-most position, prototype bus contentions may occur. 


Both jumpers J1041 and J3051 are shipped in the right-most position. 
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Z80A EMULATOR TIMING 


In Emulation Modes 1 and 2, the emulating microprocessor resides in the Prototype Control Probe, and the 
signals between the prototype and the emulating microprocessor are buffered. Therefore, some timing 
differences exist between the Z80A emulator and a Z80A microprocessor that has been inserted directly into 
the prototype. Table 7C-4 lists these differences. Figure 7C-4 is a timing diagram corresponding to the 
signals present on the Z80A emulator. 


PROBE INTERFACE 
ASSEMBLY 


PROBE INTERFACE 
ASSEMBLY 


CLK 
TEST 
PROTOTYPE POINT 


CLOCK 


PROTOTYPE 
CLOCK 


Z80B 
PROBE PLUG 


Z80B 
PROBE PLUG 


USER (ADD THIS LINE) 


PROTOTYPE 
CIRCUITRY USER 
PROTOTYPE 
CIRCUITRY i 
(BREAK THIS LINE) 
STANDARD ADAPTED 
CONFIGURATION CONFIGURATION 


3665-14 


Fig. 7C-3. Connecting the prototype clock input directly to the Prototype Control Probe. 


REDUCING DELAY THROUGH THE PROTOTYPE CONTROL PROBE 
(Z80B ONLY) 


The clock test point (on the Driver/Receiver board) can be used to obtain more accurate emulator timing 
under worst-case conditions above 4 MHz operation. In order to use the clock test point, you must discon- 
nect the prototype clock input pin from the prototype logic, and reconnect it directly to the clock test point in 
the Prototype Control Probe using a plug-on connector. 


The clock test point is located on the output of U1050 (pin 18 through a 68 2 resistor in series), and the 
output is within 10 ns of the actual CPU clock. When the prototype clock is connected directly to the clock 
source in the Prototype Control Probe, the 20 ns delay through probe circuitry is circumvented. Figure 7C-3 
illustrates the standard configuration and the adapted configuration for the prototype circuitry when imple- 
menting this clock test point user adaptation. 
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Table 7C-4 
Representative Z80A Emulator/Z80A Microprocessor Timing Differences 


Clock period 


Clock pulse width, clock high 110 


t(w(oL)) Ciock puise width, clock iow 110 2000 110 2000 ns 


t( 

t(S¢(D)) Data setup time to rising edge of clock 50 70' ns 
during M1 cycle 

t(S¢(D)) Data setup time of falling edge of clock 80' ns 
during M2 to M5 

t(DL¢(MR)) | MREQ delay from falling edge of clock, 20 85 359 1009 ns 
MREQ low 

t(DH¢(MR)) | MREQ delay from rising edge of clock, 85 1009 ns 
MREQ high . 

t(DH¢(MR)) | MREQ delay from falling edge of clock, 85 1009 ns 
MREQ high 

t(DL¢(IR)) IORQ delay from rising edge of clock, 75 ns 
IORQ low 

t(DL@(IR)) IORQ delay from falling edge of clock, 1009" ns 
IORQ low 

t(DH¢(IR)) IORQ delay from rising edge of clock, 85 1009 ns 
lIORQ high 

t(DH¢(iR)) IORQ delay from falling edge of clock, 85 1009 ns 
IORQ high 

85 959 


t(DL¢(RD)) | RD delay from rising edge of clock, ns 
RD low 

t(DL¢(RD)) | RD delay from falling edge of clock , 95 1059 ns 
RD low 

t(DH@(RD)) | RD delay from rising edge of clock, 85 959 ns 
RD high 


t(DH@(RD)) | RD delay from falling edge of clock, 


85 959 
RD high 
WR delay from rising edge of clock, 65 759 
WR low 
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70-18 


Table 7C-4 (cont) 
Representative Z80A Emulator/Z80A Microprocessor Timing Differences 


Symbol Parameter Processor Emulator Units 
I 


Min. ax. in. Max. 
WR delay from falling edge of clock, 
WR low 
WR delay from falling edge of clock, 
WR high 


t(DL(M1)) M1 delay from rising edge of clock, 1109 ns 
M1 low 


t(DH(M1)) M1 delay from rising edge of clock, 100 1109 ns 
M1 high 
t(DL(RF)) RFSH delay from rising edge of clock, 1409 ns 
RFSH low 
t(DH(RF)) RFSH delay from rising edge of clock, 1309 ns 
RFSH high 


t(S(WT)) WAIT setup time to falling edge of clock a ns 
t(D(HT)) HALT delay time from falling edge of clock F800 F818 | ns 
t(s(IT)) INT setup time to rising edge of clock eae ns 


t(DL¢(WR)) 


ns 


t(s(BQ)) BUSRQ setup time to rising edge of clock ns 

t(DL(BA)) BUSAK delay from rising edge of clock, 100 1109 ns 
'| BUSAK low 

t(DH(BA)) BUSAK delay from falling edge of clock, 100 1109 ns 
BUSAK high 


t(s(RS)) RESET setup time to rising edge of clock | 60 | 1088 105' ns 


t(F(C)) Delay to/from float (MREQ, IORQ, 1159 ns 
RD, and WR) 
t(mr) M1 stable prior to |ORQ Interrupt Ack.) ae ns 


*t(c) = t(w(H)) + t(w(dL)) + t(r) + t(f) 

‘Although static by design, testing guarantees a t(w(¢H)) of 200 us maximum. 

°Clock delay from the prototype to emulator CPU is 20 ns maximum. 

‘4Delay measured from BUSAK asserted at CPU. 

*Data will go to an indeterminate state, but will not tri-state unless BUSREQ is asserted. 


‘Timing reference is to CPU clock. To reference prototype clock, subtract propagation delay through 
driver/receiver buffers (10 ns maximum). 


STiming reference to CPU clock. To reference prototype clock, add propagation delay through 
driver/receiver buffers (20 ns maximum.) 


htORQ can be delayed to maximum of 153 ns during INTA cycles while the Debug TRA MODE is active. 
‘t(mr) = 2 * t(c) + t(w(dH)) + t(f) —65 
CPU timing reference: Mostek Microcomputer Z80 Data Book; Mostek Corporation. (1978). 
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Z80B EMULATOR TIMING 


In Emulation Modes 1 and 2, the emulating microprocessor resides in the Prototype Control Probe, and the 
signals between the prototype and the emulating microprocessor are buffered. Therefore, some timing 
differences exist between the Z80B emulator and a Z80B microprocessor which has been inserted directly 
into the prototype. Table 7C-5 lists these differences. Figure 7C-4 is a timing diagram corresponding to the 
signals present on the Z80B emulator. 


Tabie 7C-5 
Representative Z80B Emulator/Z80B Microprocessor Timing Differences 


Symbol Parameter Processor Emulator | Units 
Min. Max. Min. Max. 
ae 


t( 

a a oe 

t(w(oL)) 70 2000 | 70 2000 | ns 
during M1 cycle 


t(Sd(D)) Data setup time to falling edge of clock 30 5.0' ns 
during M2 to M5 


t(DL¢(MR)) | MREQ delay from falling edge of clock, —- 20 60 30° 753 ns 
MREQ low 


t(DH¢(MR)) | MREQ delay from rising edge of clock, 759 ns 
MREQ high 
t(DHd(MR)) | MREQ delay from falling edge of clock, 759 ns 
MREQ high 
t(DL¢(IR)) IORQ delay from rising edge of clock, 759" ns 
IORQ low 
759 


t(DL@(IR)) IORQ delay from falling edge of clock, 60 ns 
lIORQ low 


1IORQ delay from rising edge of clock, 
IORQ high 


IABRN aAalay fr 


A 
! writ uciay 


IORQ high 


RD delay from rising edge of clock, RD low a ac 
RD delay from falling edge of clock, RD low 809 
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Table 7C-5 (cont) 
Representative Z80B Emulator/Z80B Microprocessor Timing Differences 


Symbol Parameter Processor Emulator Units 
Min. Max. Min. Max. 

t(DH¢(RD)) | RD delay from rising edge of clock, RD high pO 702 | ns 

CORA) or | 


5 
t(DH¢(WR)) | WR delay from falling edge of clock, WR high 55 
t(DL(M1)) M1 delay from rising edge of clock, M1 low 
’ a2 


t(DH(M1 M1 delay from rising edge of clock, M1 high 


) 
t(DL(RF)) RFSH delay from rising edge of clock 100 
RFSH low 
t(DH(RF)) RFSH delay from rising edge of clock, 
RFSH high 


t(S(WT)) WAIT setup time to falling edge of clock 
t(D(HT)) HALT delay time from falling edge of clock 


t(s(IT)) INT setup time to rising edge of clock 


t(s(BQ)) BUSRQ setup time to rising edge of clock 40 75! ns 


1109 ns 


a) 
” 


1109 ns 


2159 ns 


=) 
n 


100 
40 

200 
45 


t(DL(BA)) BUSAK delay from rising edge of clock, 75 
BUSAK low 
( )) BUSAK delay from falling edge of clock, 55 659 ns 
BUSAK high 


( 
t(DH(BA 


; 
3 
n 


t(s(RS)) RESET setup time to rising edge of clock 45 fl ns 

t(F(C)) Delay to/from float (MREQ, IORQ, RD, 959 ns 
and WR) 

t(mr) M1 stable prior to IORQ (Interrupt Ack.) re re ns 


*t(c) = t(w(oH)) + t(w(dL)) + t(r) + t(f). 

Although static by design, tesing guarantees a t(w(¢H)) of 200 ns maximum. 

“Clock delay from prototype to emulator CPU is 20 ns maximum. 

“Delay measured from BUSAK asserted at CPU. 

“Data will go to an indeterminate state, but will not tri-state unless BUSREQ is asserted. 


‘Timing reference is to CPU clock. To reference prototype clock, subtract propagation delay through 
Driver/Receiver Buffers (10 ns maximum). 


. 5Timing reference to CPU clock. To reference prototype clock, add propagation delay through Driver/Receiver 
Buffers (20 ns maximum). 


"Emulation Mode 1, on a memory change from system to prototype, MREQ or |ORQ would be delayed up to 184 ns. 
‘(mr) = 2 * t(c) + t(w(dH)) + t(f) —50. 
NORQ can be delayed a maximum of 153 ns during INTA cycles while the Debug TRA MODE is active. 


7C-20 REV AUG 1982 


Z80 Emulator Specifics Users Emulator Timing 


tF(AD) 


tW(OL) 


tDL(M1) 


' 
tDHO(MR} 4 
MREQ 
tDLO(RD) peels 1DH®(RD} a 
@ 
| tDLO(WR) 
WR B tdcm 
tDLOUIR) tDLOUIR} 
tDHOUIR) | | | ;' 
a | nt ai ae tDHO(IR} i: J 
a IN K er 
mm Beek 5 
I | tDLO(RD) 
1DHO(RD) 4 } 
RD i A pee | ff 
st - 
tDLO(WR 
) DHOWwR) 4 
a 


1DH(BA) 


BUSAK i \ 
; tH 


(3564. 5)3964-3 


Fig. 7C-4. Z80 microprocessor bus timing. 
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Z80A PROBE/PROTOTYPE INTERFACE DIAGRAM 


Figure 7C-5 is a block diagram of the interface between the prototype and the emulating microprocessor in 
the Prototype Control Probe. This figure provides a functional overview of emulator buffering. Signal buffers 
labeled with a generic chip type (i.e., LS244) represent single level buffering. Non-labeled blocks represent 
possible multi-level buffering. A more detailed circuit description can be found in the 280 Emulator Processor 
Service Manual. 


Z80B PROBE/PROTOTYPE INTERFACE DIAGRAM 


Figure 7C-6 is a block diagram of the interface between the prototype and the emulating microprocessor in 
the Prototype Control Probe. This figure provides a functional overview of emulator buffering. Signal buffers 
labeled with a generic chip type (i.e., LS241) represent single level buffering. Non-labeled blocks represent 
possible multi-level buffering. A more detailed circuit description can be found in the 280 Emulator Processor 
Service Manual. 
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Fig. 7C-5. Block diagram of Z80A emulator/prototype interface. 
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Fig. 7C-6. Block diagram of Z80B emulator/prototype interface. 
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INSTALLING YOUR Z80 EMULATOR SOFTWARE 


8540 FIRMWARE INSTALLATION PROCEDURE 


The ROM devices that contain the control software for your Z80 emulator must be installed in your 8540's 
System ROM board. Refer to your Emulator Installation Manual for instructions on installing these ROM. 


8550 SOFTWARE INSTALLATION PROCEDURE 
Your emulator installation software consists of two disks: 


® a disk that contains emulator control software, which you install onto your DOS/50 system disk so that 
DOS/50 can control your emulator hardware. 


¢ adisk that contains Z80 emulator diagnostic software. For a Z80A emulator, you must install this disk 


onto your 8550 system diagnostic disk so that diagnostic tests can be run on your emulator as well as 
other 8550 system hardware. For a Z80B emulator, the diagnostic disk can be used directly. 


This subsection describes how to install the emulator control software for a Z80 emulator. 


To complete this staliaton procedure you need the following items: 

* an 8550 system (with or without a Z80 emulator); 

¢ a DOS/50 system disk with a write-enable tab over the write-protect slot; 
¢ a 2Z80 emulator software installation disk with no write-enable tab; and 


° (for installation of Z80A diagnostic software) an 8550 system diagnostic disk with a write-enable tab over 
the write-protect slot. 


This installation procedure takes about five minutes. 


Start Up and Set the Date 


Turn on your 8550 system. (For start-up instructions, refer to the Learning Guide of your 8550 System Users 


Manuai.) Piace your system disk in drive 0 and shut the drive 0 door. When you see the > prompt on your 
system terminal, place your installation disk in drive 1 and shut the drive 1 door. 


Use the DAT command to set the date and time. For example, if it is 11:05 am on October 30, 1983, tyne: 
> DAT 30-OCT-83/11:05 <CR> 


The system uses this information when it sets the CREATION time attribute of each file copied from your 
installation disk. 
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Install the Emulator Control Software 


The command file INSTALL2, which installs the emulator control software, resides on the installation disk. 


NOTE 
lf your system disk contains DOS/50 Version 1, use the command file INSTALL instead of INSTALL2. 


To execute the command file, simply type its filespec: 
> ‘VOL/EMU.Z80/INSTALL2 <CR> 


DOS/50 responds with the following message: 


* During this installation procedure, one or more of the 


* following messages may appear. IGNORE THESE MESSAGES: 
* 

5 Error 6E—Directory alteration invalid 

* Error 7E—Error in command execution 

* Error 1D—File not found 


* If any OTHER error message appears, see your 
* Users Manual for further instructions. 


* If no other error message appears, you'll receive a 
* message when the installation procedure is complete. 


T, OFF 


In this installation procedure, you may disregard error messages 6E, 7E, and 1D; these messages have no 
bearing on the success of the installation. However, if a message other than 6E, 7E, or 1D appears, take the 
following steps: 


1. Make sure you are using the right disks. 
2. Make sure your system disk has a write-enable tab. 
3. Make sure there are at least three files and 20 free blocks on your system disk. 


4. Begin the installation procedure again. 


If the installation procedure fails again, copy down the error message and contact your Tektronix service 
representative. 


The T, OFF command suppresses subsequent output to your system terminal (except error messages) until 
INSTALL2 finishes executing. Within about five minutes, INSTALL2 will finish and your system terminal will 
display the following message: 


* 


* Your installation has been successfully completed. 
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Install the Emulator Diagnostic Software 


If you are using a Z80A emulator, you can now install the emulator diagnostic software. If you are using a 
Z80B emulator, you can use the emulator diagnostic software disk as provided. 


Note the Name of Your Diagnostic Disk. In order to install the emulator diagnostic software, you must 
know the name of your 8550 system diagnostic disk. Remove your emulator installation disk from drive 1 
and insert the diagnostic disk. Enter the following command to list the names of the two disks mounted in 


your 8550: 
> ATT /VOL/* WHERE <CR> 
sysvol WHERE=FLXO «—— DOS/50 system disk 
8550DIAGx.x WHERE=FLX1 ~—— 8550 system diagnostic disk 


Note the name of your diagnostic disk. (It should be something like 8550DIAG2.0.) 


Insert Your Emulator Installation Disk into Drive 1. INSTALLDIAGS, the command file that installs the 
diagnostics, resides on the installation disk. Remove your diagnostic disk from drive 1 and insert your 
installation disk. Invoke the INSTALLDIAGS command file and pass it the name of your diagnostic disk, 
which you just noted: 

> /VOL/EMU.Z80/INSTALLDIAGS 8550DIAGx.x <CR> 


DOS/50 responds with the following messages: 


wR KR KKK KK KR KK RK KR KKK KK KK KKK KKK KKK KKK KEK KK EK KE KE 


: DIAGNOSTIC INSTALLATION PROCEDURE = 

OK ROK KKK KK KK KKK EK KK KE KK KK KK KK KK KKK KK KK KKK KK KK KE 

*« 

. During this installation procedure, the following error 

ie message will appear once. IGNORE THIS MESSAGE: 

* 

- Error 2A Parameter required 

* 

x If any OTHER error message appears or this appears more 

* than once, see your Users Manual for further instructions. 
* 

* If no other error message appears, you'll receive a message 
- when the installation is complete. 

* 

T,OFF 

COP: Error 2A Parameter required 


*” 


* —— Remove the DOS/50 System Disc 

* ——® Insert the 8550 System Diagnostic Disc 
* ——> Type CO -A 

SUSP, A 

>> 
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Insert Your Diagnostic Disk into Drive 0. Remove your 8550 system disk from drive 0 and insert your 8550 
system diagnostic disk. Then enter the command CO -A to continue execution of the command file: 
S00 ah <ck> 


After a few minutes, the following message is displayed: 


COP, -BN,/VOL/EMU.2Z80/DIAGS/Z80.TST,/VOL/8550DIAGx.x/Z80.TST 
* —— Remove 8550 System Diagnostic Disc 

* ——® Insert DOS/50 System Disc 

* ——* Press CTRL-C 

* —— Type CO -A 


SUSP, -A 


Insert Your DOS/50 System Disk into Drive 0. Remove your diagnostic disk from drive 0 and insert your 
DOS/50 system disk. Then enter the CO -A command again: 
> CO -A <CR> 


The command file finishes with the following message: 
USER, ,NO.NAME 


HR RK KR RK KKK RR KK KE KE KKK KKK KKK KK EK KK KK RK KK KK KK KE 


i. DIAGNOSTIC INSTALLATION COMPLETE = 


eR KR EK KK RRR RR RR RK KR RE KK RR ER KR KK KK KR KK KK KEK KE 


> 


In this installation procedure, error message 2A should appear once. If any other error message appears, 
check your disks and begin the diagnostic installation procedure again. If the installation procedure fails 
again, copy down the error message and contact your Tektronix service representative. 


Once your software is installed, you can: 
® remove your disks and turn off your 8550 system, or 
* install more software, or 


® continue with the Z80 Emulator Demonstration Run that follows in this section. If you do this, you do not 
have to restart the system or reset the date and time. 


NOTE 


At this point NO.NAME is the current user. To change the current user back to yourname, enter 
USER, ,yourname. 
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Z80 DEMONSTRATION RUN 


INTRODUCTION 


This demonstration run shows you how to 
load, execute, and monitor a simple Z80 as- 
sembly language program on your 8540 or 
8550. In order to perform this demonstration, 
your Z80 emulator hardware and control 
software must be installed in your 8540 or 
8550. 


Figure 7C-8 shows the source and object 
code for the demonstration program. 


If you have an 8550 (as in Fig. 7C-7, Case 1), 
the source code and object code for the dem- 
onstration program are provided on the in- 
Stallation disk that contains your Z80 
emulator control software. This demonstra- 
tion shows you how to assemble the pro- 
gram on your 8550. (If your system disk does 
not contain a Z80 assembler, you will have to 
skip that part of the demonstration.) 


If you have an 8540/8560 system (See Fig. 
7C-7, Case 2), and your 8560 has a Z80 as- 
sembler installed, you can create and assem- 
ble the program on the 8560 and then 
download it to the 8540. This demonstration 
shows how. 


If you have an 8540 (Fig. 7C-7, Case 3) that 
is connected to a host computer other than 
an 8560, we can’t give you a specific list of 
commands for creating and assembling the 
program on your host (since we don’t know 
what host you’re using). However, Fig. 7C-9 
gives the object code for the program in Ex- 
tended Tekhex format. You can create the 
Tekhex file using your host’s assembler or 
text editor, and then download the file to the 
8540 via the 8540's optional COM interface. 


If none of these cases applies to you, you 
can patch the program into memory by using 
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the P command. This demonstration shows 
how. 


Once the program is loaded or patched into 
memory, you can execute the program on 
your emulator. 


ey 
HIF | 


must have Z80. 
assembler 


8540 + 8560 


on 
mae 


8540 + other host 


‘Case 4: any other configuration 


3964-5A 


Fig. 7C-7. System configurations. 
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NOTE 


The 8540 commands shown in this demonstration can also be used for an 8550 that is connected to 
an 8560 or other host computer. 


01 ;Z80 DEMONSTRATION RUN PROGRAM 

02 SECTION DEMO 

0% ORG 100H ;START PROGRAM CODE AT ADDRESS 100 
04 000100 210005 START LD HL,TABLE ;SET TABLE POINTER 

05 000103 0605 LD B,TSIZE  ;SET PASS COUNTER 

06 000105 AF XOR A ;CLEAR ACCUMULATOR 

O07 000106 86 LOOP ADD A,(HL) ;ADD BYTE FROM TABLE 

08 000107 23 INC HL ;POINT TO NEXT BYTE 

09 000108 05 DEC B ;DECREMENT PASS COUNTER 

10 000109 ¢20601 JP NZ,LOOP ;LOOP IF NOT FIVE PASSES YET 

11. 00010C D3F7 OUT (OF7H),A j;OTHERWISE CALL EXIT Svc 

12 OO010E 00 NOP ; TO END PROGRAM EXECUTION 

15 ;SRB POINTER 

14 ORG 40H ;STORE SRB POINTER AT ADDRESS 40 
15 000040 000042 BYTE 00,42H ;POINT TO SRB FOR EXIT SVC 

16 ;SRB FOR EXIT SVC 

17 000042 1A BYTE 1AH -1AH = FUNCTION CODE FOR EXIT SVC 
16 ;TABLE OF NUMBERS TO BE ADDED | 

19 TSIZE EQU 5 STABLE SIZE = 5 

20 ORG 500H :SET UP TABLE AT ADDRESS 500 

21 TABLE BLOCK TSIZE 


source code 


comments 


object code 


address 


source code line number 


7C-30 


Fig. 7C-8. Demonstration program. 
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(A) 


%2769231002100050605AF862305C 20601D3F700 


GOR62B24000421A 
$38 3494DEM0010350514L00P310615START31001 5TABLE350025TSIZE15 
%0981 53100 


(B) 
FIRST DATA BLOCK: object code for addresses 100--10E 


header 
load address object code 


=Eeres = = en 


%2769231002100050605AF862305C 20601D3F700 


SECOND DATA BLOCK: object code for addresses 40--42 


header 
load object 
address code 
| 


ed a 


OB 62B24000421A 


SYMBOL BLOCK 


header section 
| . NEAT. 
| section definition 


| name field symbol definition fields 
| 
I 


i — =S==Ss225= _—— —— 


%383494DEM0010350514L00P310615START31001 5TABLE350025TSIZE15 


TERMINATION BLOCK 


header 
| transfer 
address 
| 
| 


0961535100 


Fig. 7C-9. Demonstration program: Extended Tekhex format. 
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Figure 7C-9A shows an Extended Tekhex load module that contains the object code and program symbols 
for the demonstration program. Figure 7C-9B labels the different fields in the message blocks. If you have a 
host computer other than an 8560, you can create this load module and download it to your 8540 or 8550. 


EXAMINE THE DEMONSTRATION PROGRAM 


The demonstration program adds five numbers from a table stored in locations 500 to 504 in program 
memory and leaves the sum in register A. (You will place values in the table later in this demonstration.) The 
8085A emulator demonstration run in the Learning Guide of your System Users Manual! contains a flowchart 
that illustrates the steps of the Program. 


The source code contains two kinds of statements: assembler directives (such as ORG and BYTE) and Z80 
assembly language instructions. The assembler directives are microprocessor-independent and are ex- 
plained in the 8085A emulator demonstration run. The Z80 assembly language instructions are discussed in 
the following paragraphs. 


Set Table Pointer. The LD HL, TABLE instruction loads the address of the table (500) into the H-L register 
pair. As a result, the H-L pair points to the first element of the table. The lable START is used by the END di- 
rective to specify that the LD HL, TABLE instruction is the first to be executed. 


Set Pass Counter. Register B is used as the pass counter. The LD B, TSIZE instruction loads the value 5 
into register B. This step sets the number of passes to 5. 


Clear Accumulator. The XOR A instruction zeros the accumulator (register A) so you can start adding 
numbers from the table. 


Add Byte from Table. The ADD A, (HL) instruction adds the byte addressed by the H-L register pair into the 
accumulator. The label LOOP represents the address of this instruction; this label is used by the JP NZ 
instruction. 


Point to Next Byte. The INC HL instruction increments the address contained by the H-L register pair; the H- 
L register pair then points to the next byte in the table. For example, the H-L register pair is initialized to 
contain 500. After the INC HL instruction is first executed, the H-L register pair will contain 501, the address 
of the second byte in the table. 


Decrement Pass Counter. The DEC B instruction decrements register B, the pass counter. In this program, 
B is decremented each time a number is added to the accumulator. 


Loop If Not Five Passes Yet. The JP NZ, LOOP instruction checks the contents of register B and jumps to 
the LOOP label if B does not contain zero. If B contains zero, the program proceeds to the next instruction, 
OUT (OF7H),A. 


Exit. The OUT (OF7H).A and NOP instructions constitute a service call (SVC) that causes an exit from the 
program. For more information on SVCs, refer to the Service Calls section of your System Users Manual. 
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ASSEMBLE AND LOAD THE DEMONSTRATION PROGRAM 


Now it’s time to create the program so you can run it on your emulator. One of the following discussions 
describes the set of steps that is appropriate for your hardware configuration: 


e For 8550 users—Case 1: Assemble and Load on the 8550 
® For 8540/8560 users—Case 2: Assemble on the 8560; Download to the 8540 


°¢ For 8540 users with a host computer other than the 8560—Case 3: Download from Your Host to the 
8540 


¢ For other hardware configurations—Case 4: Patch the Program into Memory 


Go ahead and work through the discussion that’s appropriate for you. Once you’ve put the program into 
program memory, turn to the heading Run the Demonstration Program, later in this section. 


CASE 1: ASSEMBLE AND LOAD ON THE 8550 


This discussion shown you how to copy the demonstration program from your Z80 emulator software 
installation disk, assemble the program, and load it into 8550 program memory. 


Start Up and Log On 


Turn on your 8550 system. (For start-up instructions, refer to the paragraph Start Up the 8550 and Its 
Peripherals in the Learning Guide of your System Users Manual.) Place your system disk in drive 0 and shut 
the drive 0 door. When your system displays the > prompt, place your Z80 emulator software installation 
disk in drive 1 and shut the drive 1 door. 


Use the DAT command to set the current date and time. For example, if it is 2:30 pm on October 31, 1981, 
enter the following command line: 
> DAT 31-OCT-81/2:30 PM <CR> 


Use the SEL command to tell DOS/50 to use the assembler and emulator software designed for the Z80: 
> SEL Z80 <CR> 


The SEL command automatically sets the emulation mode to 0. 


Copy the Demonstration Run Program from the Installation Disk 


Enter the following command lines to create an empty directory called DEMO on your system disk and make 
DEMO the current directory. The BR command creates a brief name, ROOT, to mark the oid current 
directory. At the end of this demonstration, you will return to this ROOT directory and delete the DEMO 
directory and its contents. 


> BR ROOT/USR <CR> 
> CREATE DEMO <CR> 
> USER DEMO <CR> 
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Now use the COP command to copy all the files in the DEMO2 directory on the installation disk to the DEMO 


directory you just created: 
> COP /VOL/EMU.Z80/DEM02/* * <CR> 


Remove your installation disk from drive 1 and put it away. 


Now list the files you have just copied to the current directory: 


> L <CR> 

FILENAME 

ASM 

LOAD 

Files used 124 
Free files 132 
Free blocks 821 
Bad blocks 0) 


The file named ASM contains the assembly language source code for this demonstration program, and the 
file named LOAD contains the executable object code. This copy of LOAD will be used in the demonstration 
only if you do not have a Z80 assembler (and thus cannot create your own object file and load file from the 


source file.) 


Examine the Demonstration Program 


Enter the following command line to display the source file ASM on the system terminal: 


> CON ASM <CR> 
;280 DEMONSTRATION RUN PROGRAM 
SECTION DEMO 


ORG 100H ;START PROGRAM CODE AT ADDRESS 100 
START LD HL,TABLE 5;SET TABLE POINTER 

LD B,TSIZE ;SET PASS COUNTER 

XOR A ;CLEAR ACCUMULATOR 
LOOP ADD A, (HL) ;ADD BYTE FROM TABLE 

INC HL ;POINT TO NEXT BYTE 

DEC B ;DECREMENT PASS COUNTER 

JP NZ, LOOP ;LOOP IF NOT FIVE PASSES YET 

OUT (OF7H),A ;OTHERWISE CALL EXIT SVC 

NOP ;TO END PROGRAM EXECUTION 
;SRB POINTER 

ORG 40H ;STORE SRB POINTER AT ADDRESS 40 

BYTE 00,42H ;POINT TO SRB FOR EXIT SVC 
;SRB FOR EXIT SVC 

BYTE 1AH ;l1AH = FUNCTION CODE FOR EXIT SVC 
;TABLE OF NUMBERS TO BE ADDED 
TSIZE EQU 5 ;TABLE SIZE = 5 

ORG 5O00H ;SET UP TABLE AT ADDRESS 500 
TABLE BLOCK TSIZE 

LIST DBG 

END START 
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Assemble the Source Code 


If you do not have a Z80 assembler on your system disk, you cannot perform this step, so skip the next four 
commands (ASM, COP, LINK, and L). 


The ASM (AsSeMble) command translates assembly language (source code) into binary machine language 
(object code). The ASM command also creates an assembler listing that can be used to correlate the object 
code with the source code. Enter the following command line to assemble the source code in the file ASM 
and create the listing the object files ASML and OBJ: 

> ASM OBJ ASML ASM <CR> 


4 4 A 

I t 1 

t 1 ! 

Il..--<— source file 

! ! 

lane ene n assembler listing file 

I 

l- eee object file 
Tektronix Z80 ASM Vx.x 


eee Pass: 2 
23 Source Lines 23 Assembled Lines xxxxx Bytes Available 
>>> No assembly errors detected <<< 


Make sure your line printer is turned on and properly connected, then enter the following command to copy 
the assembler listing onto the printer: 
> COP ASML LPT <CR> 


Refer to Fig. 7C-8 for an explanation of the different fields in your assembler listing. For a more detailed 
explanation, consult your Assembler Users Manual. 


Link the Object Code. The linker creates an executable load file from one or more object files. Enter the 
LINK command to invoke the linker: 


> LINK <CR> 
8550 LINKER Vx.x 


* 


Now enter the following linker commands to create a load file called LOAD from your object file, OBJ: 
*LINK OBJ <CR> 
*LOAD LOAD <CR> 
*DEBUG <CR> 
*END <CR> 


The linker commands LINK and LOAD specify the object file and load file, respectively. The DEBUG com- 
mand causes the linker to pass the program symbols from the object file to the load file, for use in program 
debugging. After you type the END command, the linker executes the commands you have entered, and the 


following information is displayed: 


NO ERRORS NO UNDEFINED SYMBOLS 
1 MODULE 1 SECTIONS 
TRANSFER ADDRESS IS 0100 
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The files generated by the ASM and LINK commands should now be on your disk. Enter the following 
command to list the files in your current directory: 


Files used 
Free files 


Free blocks 


Bad blocks 


Notice that there are now four files listed in your directory. OBJ and ASML were created by the assembler, 


and LOAD was created by the linker. 


Load the Program into Memory 


Now it’s time to load the object code from the load file LOAD into program memory. Once you've loaded the 
object code, you execute the program. 


Zero Out Memory. Before you load any code, use the F (Fill) command to fill program memory with zeros. 
Later, when you examine memory, the zeros make it easy to identify the beginning and end of your code. 
(Zeroing out memory has no affect on how the program is loaded.) Enter the following command line to fill 


memory addresses 40 to 11F with zeros: 
> F 49 11F 00 <CR> 


Check That Memory Was Filled with Zeros. Check the contents of memory with the D (Dump) command. 
The D command's display shows the data (in hexadecimal format) and also shows the corresponding ASCII 


characters. Display the contents of memory addresses 40 to 11F with the following command line: 
> D 40 11F <CR> 


000040 
000050 
000060 
000070 
000080 
000090 
OOOOAO 
OOOOBO 
O000CO 
OOOO0EO 
OOOOFO 
000100 
000100 


0) 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


nt 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


2 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


3 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


9 

00 
00 
00 
oO 
00 
00 
00 
00 
00 
00 
00 
00 
00 


A B ¢ 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


oo 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


D E F 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
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Load the Object Code into Memory. Enter the following command line to load the object code for the 
demonstration program into program memory: 
> LO <LOAD <CR> 


h 


r 
load file 


Load the Program Symbols. The source code for the demonstration program contained the directive LIST 
DBG. Because of this directive, the object file contains a list of the symbois that appeared in the source 
code, and the values associated with those symbols. Because you included the DEBUG command when you 
invoked the linker, those symbols were passed to the load file. Use the SYMLO command to load those 
symbols into the symbol table in 8550 system memory. 

> SYMLO-S <LOAD <CR> 


The -S option means that both addresses and scalars are loaded. If you omit the -S, only addresses are 
loaded. (A scalar is a number that is not an address — for example, TSIZE, the length of the table.) 


Later in this demonstration, whenever you use a symbol in a command line, DOS/50 refers to the symbol 
table to find the value that the symbol represents. 


You've assembled and linked the demonstration program and loaded it into memory. Now skip ahead to the 
heading Run the Demonstration Program. 


CASE 2: ASSEMBLE ON THE 8560; DOWNLOAD TO THE 8540 


This discussion shows you how to create the demonstration program source code and assemble it on the 
8560, then download it to 8540 (or 8550) program memory. If your 8560 does not have a Z80 assembler, 
you cannot complete this part of the demonstration, so skip ahead to the heading CASE 4: Patch the 
Program into Memory. 


Start Up and Log In 


Start up your 8540, make sure it’s in TERM mode, and log in to the 8560 operating system, TNIX. See your 
8560 System Users Manual for details. 


Since you’re logged in to TNIX, your system prompt is $. (Later in the demonstration, we'll show the system 
promot as >, in deference to people using 8540s and 8550s in LOCAL mode.) Every command you enter is 
processed by TNIX. If you enter an OS/40 command, TNIX passes it to the 8540. 


Enter the following commands to select the Z80 assembler on the 8560 and the Z80 emulator on the 8540: 
$ uP =z803; export UP <CR> 


$ sel Z80 <CR> 


The se/ command automatically sets the emulation mode to 0. 
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Create the Demonstration Program 


Enter the following TNIX command lines to create an empty directory called demo and make demo the 
working directory. You'll create your source file and related files in this demo directory. 


$ mkdir demo <CR> 
$ ed demo <CR> 


Now use the TNIX editor ed, to create the demonstration program source file. The following command line 
invokes the editor and specifies that you want to create a file called asm: 


$ ed asm <CR> 
P?asm 


The editor responds ?asm to remind you that asm does not already exist. Notice that the editor does not 
give a prompt to let you know that it’s ready for input. 


Enter the Text. Now enter the editor command a (append text) and type in the program. Use the BACK- 
SPACE key to erase any typing mistakes. 


a <CR> 
column column column 
8 6 24 


3;Z80 DEMONSTRATION RUN PROGRAM <CR> 
SECTION DEMO <CR> 


ORG 100H ;START PROGRAM CODE AT ADDRESS 100 <CR> 
START LD HL,TABLE ;SET TABLE POINTER <CR> 
LD B,TSIZE ;SET PASS COUNTER <CR> 
XOR A ;CLEAR ACCUMULATOR <CR> 
LOOP ADD A, (HL) ;ADD BYTE FROM TABLE <CR> 
INC HL ;POINT TO NEXT BYTE <CR> 
DEC B ;DECREMENT PASS COUNTER <CR> 
JP NZ,LOOP ;LOOP IF NOT FIVE PASSES YET <CR> 
OUT _(OF7H),A ;OTHERWISE CALL EXIT SVC <CR> 
NOP ; TO END PROGRAM EXECUTION <CR> 
;SRB POINTER <CR> 
ORG 40H ;STORE SRB POINTER AT ADDRESS 40 <CR> 
BYTE 00,42H ;POINT TO SRB FOR EXIT SVC <CR> 
;SRB FOR EXIT SVC <CR> 
BYTE 1AH 3;1AH = FUNCTION CODE FOR EXIT SVC <CR> 
;TABLE OF NUMBERS TO BE ADDED <CR> 
TSIZE  EQU 5 ;TABLE SIZE = 5 <CR> 
ORG 500H ;SET UP TABLE AT ADDRESS 500 <CR> 


TABLE BLOCK TSIZE <CR> 
LIST DBG <CR> 
END START <CR> 
« <CR> 


At the end of your text, enter a period on a line by itself. The editor will now accept new commands. 
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Check for Errors. Type the following editor command to display the text you have entered. Check for typing 
mistakes. 
1,$p <CR> 


I print command: displays the lines 
in the designated range 
I 


-—---- designates last line in file 


designates first line in file 


If you made any mistakes, fix them now. In case you're not familiar with the editor, Table 7C-6 lists the 
commands you need in order to add, delete, or replace a line. For more information on the TNIX editor, refer 
to your 8560 System Users Manual. 


Table 7C-6 
Basic 8560 Editing Commands 


Command Function 

mm,nnp <CR> Displays lines mm through nn 
nn<CR> Makes line nn the current line 
d<CR> Deletes the current line 

a<CR> Adds text below the current line 
<line(s) of text> 

.<CR> 

c<CR> Replaces the current line with the text 
<line(s) of text> you type in 

.<CR> 


a 


Once your text is correct, enter the w command to write the text to the source file, asm: 


w <CR> 
902 


The editor responds with the number of characters written to the file. 


Finally, enter the q command to quit the editor and return to TNIX: 
q <CR> 
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Assemble the Source Code. 


The TNIX asm (assemble) command translates assembly language (source code) into binary machine lan- 
guage (object code). The asm command also creates an assembler listing that you can use to correlate the 
object code with the source code. Enter the following command line to assemble the source code in tne file 
asm and create the listing and object files asm/ and obj: 

$_asm obj asml asm <CR> 


t 

! 

! L-.--. source file 

t 

L------+- assembler listing file 
oe ea at Os a object file 


Tektronix ASM Z80 
Vxx.xx-xx (8560) 
ee ek Pass 2 


23 Lines Read 
23 Lines Processed 
O Errors 


Enter the following command to print the assembler listing on the 8560’s line printer: 
$ lplr asml <CR> 


Examine page 1 of your listing. Did the assembler issue any error messages? There should be none. If your 
source code contains errors, take the following steps. 


1. Refer to your Assembler Users Manual to find out what the error messages mean. 


2. Enter the command ed asm to get back into the editor and fix the mistakes in your source code. Exit the 
editor with the w and g commands, as before. 


3. Enter the command asm obj asml/ asm to re-assembie your source code. 


Link the Object Code 


The linker creates an executable load file from one or more object files. Enter the following command to 
create a load file called /oad from your object file, obj. Be sure to enter all parameters exactly as shown. 
$ link -d -O0 obj -o load <CR> 


The -d option causes the linker to pass the program symbols from the object file to the load file, for use in 
program debugging. 


The files generated by the asm and link commands should now be in your working directory, demo. Enter the 
following command to list the files in your working directory: 

$ 1s <CR> 

asm 

asml 

load 

obj 
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Notice that there are now four files listed in your directory: obj and asm/ were created by the assembler, and 
load was created by the linker. 


Download the Program to the 8540 


Now it’s time to download the object code produced by the 8560’s linker into 8540 program memory. 


Zero Out Memory. Before you download any code, use the OS/40 F (Fill) command to fili 8540 program 
memory with zeros. Later, when you examine memory, the zeros make it easy to identify the beginning and 
end of your code. (Zeroing out memory has no effect on how the program is loaded.) Enter the following 
command line to fill memory addresses 40 to 11F with zeros: 

$ f 40 11f 00 <CR> 


Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (dump) 
command. The D command’s display shows the data in hexadecimal format, and also shows the corre- 
sponding ASCII characters. Display the contents of memory addresses 40 to 11F with the following com- 
mand line: 


$ d 40 11f <CR> 
Oo 1 2 3 4 5 6 7 8 9 A B € D E F 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 O00 00 00 ..wwwecceeevaces 
000050 00 00 00 00 00 00 00 00 O00 00 00 00 00 00 00 OO 2... were cnecnaess 
000060 00 00 00 00 00 00 00 00 00 00 00 00 00 OO 00 00 .ecewwececevecees 
000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO OO 2... eee cece cence 
000080 00 00 00 00 00 00 00 00 00 00 00 00 00 OO 00 00 .eewwcccceeeecee 
000090 00 00 00 90 00 00 00 00 OO 00 00 00 OO OO OO OO 2... cee wcccnese 
OOOOAO 00 00 OO 00 OO OO O00 OO O00 00 00 OO 00 00 0D OO 2... cee eee ene 
OOOOBO 00 00 00 00 00 00 00 00 OO O00 00 00 00 00 OO OO ..cecesccwc cence 
0000CO 00 00 00 00 00 00 00 OO OO O00 00 00 00 00 OO O00 ....-... eee ene 
o0000DO 00 00 00 00 00 00 00 00 00 00 00 OO 00 OO 00 OO ..cewecceeveenne 
OOOOEO 00 00 00 90 00 00 00 00 O00 CO 00 00 00 OO OO OO 2... ene ecccnee 
OOQOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 CO 00 00 2... cceeeenoee 
000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....cw cree eveces 
000110 00 00 00 00 00 00 00 00 00 O00 00 00 00 00 OO OO ..........2..220 


Download the Object Code. Enter the following command line to download the object code from the 8560 
file oad to 8540 program memory: 
$ lo <load <LCR> 
a 


' 
load file 


Download the Program Symbols. The source code for the demonstration program contains the directive 
LIST DBG. Because of this directive, the object file contains a list of the symbols that appear in the source 
code and the values associated with those symbols. Because you included the -d option in the link com- 
mand line, those symbols were passed to the load file. Use the OS/40 SYMLO command to download those 
symbols into the symbol table in 8540 system memory. 

$ symlo -s <load <CR> 


The -s option means that both addresses and scalars are downloaded. If you omit the -S, only addresses 
are downloaded. (A scalar is a number that is not an address — for example, TSIZE, the length of the table.) 
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Later in this demonstration, whenever you use a symbol in an OS/40 command line, OS/40 refers to the 
symbol! table to find the value that the symbol represents. 


You've assembied and iinked the demonstration program and downioaded it into memory. Now skip ahead 
to the heading Run the Demonstraion Program. 


CASE 3: DOWNLOAD FROM YOUR HOST TO THE 8540 


This discussion gives some general instructions for downloading the demonstration program from a host 
computer other than the 8550 or 8560 to 8540 (or 8550) program memory. If your 8540 is not equipped with 
the optional COM Interface Package, you cannot complete this part of the demonstration, so skip ahead to 
the heading Case 4: Patch the Program into Memory for instructions. COM Interface software is standard 
on the 8550. 


Since we don’t know what host computer you're using, we can only provide a general outline for creating the 
demonstration program and downloading it to the 8540. Once you have determined the command sequence 
that is appropriate for your host, record this information in the space provided in Fig. 7C-10. 


Create the Extended Tekhex Load Module 


In order for object code to be downloaded to the 8540, it must be in Extended Tekhex format, as shown in 
Fig. 7C-9. You can create the load module in one of two ways: 


1. using your host computer's text editor, key the load module in by hand; or 
2. using your host computer's Z80 assembler to 
a. translate the demonstration program into the language of your host’s Z80 assembler: 
b. create and assemble the source file; 
c. link the object code, if necessary; and 
d. translate the object code produced by the assembler or linker into Extended Tekhex format. The 


Intersystem Communication section of your System Users Manual provides a genera! algorithm for 
conversion to Extended Tekhex format. 


Prepare the 8540 


Start up your 8540 and enter the following command to select the Z80 emulator: 
> SEL Z80 <CR> 


The SEL command automatically sets the emulation mode to 0. 
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Create the Extended Tekhex Load Module 


Prepare the 8540 


(Start up the 8540.) 
> SEL Z80 <CR> 

> F 40 11F OO <cR> 

> D 40 11F <CR> 


Establish Communication 


Download the Load Module 


Terminate Communication 


Fig. 7C-10. Host computer commands for preparing demonstration program. 


Zero Out Memory. Before you download any code, use the OS/40 F (Fill) command to fill 8540 program 
memory with zeros. Later, when you examine memory, the zeros make it easy to identify the beginning and 
end of your code. (Zeroing out memory has no affect on how the program is loaded.) Enter the following 
command line to fill memory addresses 40-11F with zeros: 

> F 40 11F 00 <CR> 
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Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (Dump) 
command. The D command's display shows the data (in hexadecimal format) and the corresponding ASCII 
characters. Display the contents of memory addresses 40 to 11F with the following command line: 

> D 40 11F <CR> 

oO 12 3 4 5 6 7 8 § ABCODE F 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .eeecessssccceee 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ..cssesecceccees 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....eecesecccces 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 cececeacevcccees 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .eceseccccvccess 

C00090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ..eececeeccsccee 

O000AO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 CO .eeccccevesseces 

OOOOBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .iceeecccccccees 

O000CO:-00°.00/-00: 00.00: 00 0000 00" 00 00" 00-00-0000. 00 4 Miwicuiceet aes 

Q000D0-.00 00-00: 00 00 00 00:00 00 00.00 00°00 00 00°00: wie inie.dew s'escesw's ws 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .eceeecccccseves 

OOOOFO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .iseceeccecccces 

000100 00°00 006 00 00: 00 00:00 00 00 00 00 00 00 00 00 scanicvcceseass 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .ecccececccucees 


Download the Load Module to the 8540 


Be sure that your 8540 and your host computer are connected via an RS-232-C compatible communication 
link. Refer to the Intersystem Communication section of your System Users Manual to determine the com- 
mands and parameters that are appropriate for your host computer. Then perform the following steps to 
download the Tekhex load module to 8540 program memory. 


1. Enter the 8540 COM command to establish communication. (The parameters of the COM command are 
host-specific.) Log on to your host and execute any necessary host initialization commands. 


2. Enter the command line that downloads the Tekhex load module to the 8540. This command line consists 
of the host computer command that performs the download, followed by a null character (CTRL-@ on 
most terminals) and a carriage return. COM places the object code in 8540 program memory, and puts 
the program symbols into the symbol table in 8540 system memory. 


3. Log off from your host, and then terminate COM command execution by entering the null character, then 
pressing the ESC key. 


Once you've downloaded the program to the 8540, skip ahead to the heading Run the Demonstration 
Program. 


CASE 4: PATCH THE PROGRAM INTO MEMORY 


This discussion shows you how to patch the demonstration program into 8540 (or 8550) program memory 
using the P command, and then add the program symbols into the symbol table using the ADDS command. 


Ordinarily, you would load the object code and symbols from a binary or hexadecimal load file, as illustrated 
for Cases 1, 2, and 3. The procedure presented here is not normally used for preparing a program for 
execution. Use this procedure only if you have no standard means for preparing the program, but would still 
like to try out your emulator. 
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Start Up the 8540 


Start up your 8540 and enter the following command to select the Z80 emulator: 
> SEL Z80 <CR> 


The SEL command automatically sets the emulation mode to 0. 


Zero Out Memory 


Before you patch in any code, use the OS/40 F (Fill) command to fill 8540 program memory with zeros. 
Later, when you examine memory, the zeros make it easy to identify the beginning and end of your code. 
Enter the folowing command line to fill memory from addresses 40 to 11F with zeros: 

> F 40 11F 00 <CR> 


Check That Memory Was Filled with Zeros. Check the contents of memory with the OS/40 D (Dump) 
command. The D command’s display shows the data (in hexadecimal format) and the corresponding ASCII 
characters. Display the contents of memory addresses 40 to 11F with the following command line: 

> D 40 11F <CR> 

0 1 2 3 4 5 6 7 8 9 A BCD EF 

000040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....wseeeee aeestas 

000050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2... cccccccece 

000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....cccccccccees 

000070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....cwcccccccece 

000080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO ........05. peeps 

000090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...scccaccccccce 

OO000AO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .....ceccccccece 

OOO0OBO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ........ ka atea ta 

O000CO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...ececcccccccce. 

OO00O0DO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ....... pai Ns 

OOOOEO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 OO ........2.- wares 

OGOOFO 00 00 00 60 06 00 00 00 00 00 00 00 00 00 00 OO ........ cece 

000100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ..cwwccceccccccs 

000110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ..... Sigs Aa ete 


Patch the Object Code into Memory 


The OS/40 P (Patch) command stores a sequence of bytes into memory, replacing the previous memory 
contents. Enter the following command to store the object code for the first three instructions in the program 
(LD HL, LD B, and XOR A) starting at location 100: 

> P 100 210005 0605 AF <CR> 


——— ———=—— = he 


LD B,TSIZE 
LD HL,TABLE 
patch address 


Now patch in the next four instructions (ADD A, INC HL, DEC B, and JP NZ,LOOP)... 
> P 106 86 23 05 C20601 <CR> 
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... and now the last two instructions (QUT and NOP): 
> P 10C D3F7 00 <CR> 


Finally, patch in the Exit SVC information at address 40: 
> P 40 00421A <CR> 


You'll examine the contents of memory later in this demonstration. 


Put Symbols into the Symbol Table 


Later in this demonstration, you will use symbols from the demonstration program (START, LOOP, TSIZE, 
AND TABLE) when communicating with OS/40. Whenever you use a symbol in a command, OS/40 consults 
a symbol table in 8540 system memory to find the value the symbol represents. Enter the following com- 
mand line to add the program symbols to the symbol table, along with their values: 

> ADDS START=100 LOOP=106-S TSIZE=5 TABLE =500 <CR> 


The ADDS command cannot provide all the symbol-related information that is provided by the SYMLO 
command (as in Cases 1 and 2) or the COM command (as in Case 3). Because this information is missing, 
some of the displays you produce later in this demonstration will not match the symbolic displays shown in 
this manual. For more information on the ADDS command, refer to the Command Dictionary of your System 
Users Manual. 


You've patched the demonstration program into program memory and placed the program symbols in the 
symbol table. Now it’s time to run the program. 


RUN THE DEMONSTRATION PROGRAM 


From now until the end of the demonstration, the commands you are to enter are shown in lowercase. If you 
are not logged into an 8560, you may enter commands in either lowercase or uppercase. If you are using an 
8560, you must enter the name of every command in lowercase (and your system prompt is $, not> ). 


Now that you've loaded the program into memory, you need to: 
e verify that the program was loaded correctly; and 


* put values into the table in memory, for the program to add. 
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with zeros. Look at the same memory area again with the following command line: 


> d 40 11f <CR> 


0) 


000040 
000050 
000060 
000070 
000080 
000090 
OOOO0AO 
OOOOBO 
0000CO 
O0o000DO 
OOOOEO 
OOOOFO 
000100 
000110 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


1 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


2 

00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


3. C4 

00 00 
00 OO 
00 00 
00 OO 
00 00 
00 00 
00 OO 
00 00 
00 00 
00 00 
00 00 
00 00 


00 OO. 


00 00 


5 6 7 8 

00 00 00 00 
00 00 00 OO 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 OO 
00 00 00 00 
00 O00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 


9 A B C D E F 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


The object code is loaded in two different blocks: 


® The Z80 machine instructions are loaded at address 100 (specified by the first ORG directive in the 


source code). 


e The information for the Exit SVC is loaded at address 40 (specified by the second ORG directive). 


The contents of the table at address 500 are still undefined, but you’ll put some values into the table in just a 


few minutes. 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


00 
00 
00 
ele) 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 


eseereeaeeoeer eer ee eee 


ceoeceereeer eee eee ee 


eooeoereevesree eee eee 


eeeoeoeeecereeoeoeeoees 


eoeoeereoe ere eeeeeaeos 


oeoeerereoee ee ee eee 


Turn On Symbolic Debug. Enter the following command to turn on symbolic debug: 
> symd on <CR> 


Disassemble the Object Code. The Di (Disassemble) command displays memory contents both in hexa- 
decimal notation and in assembly language mnemonics. You can use the DI command to verify that the 
object code in memory corresponds to your source code. Enter the following command to disassemble the 
area of memory occupied by the executable part of your program: 


> di 100 10e <CR> 


LOC 
SECTION 
START 
+000103 
+000105 
LOOP 
+000107 
+000108 
+000109 
+00010C 
+00010E 


Compare the DI display with the assembler listing you generated earlier, or refer back to Fig. 7C-8. 


REV AUG 1982 


IN 


ST 


(DEMO) 
210005 


06 
AF 
86 
23 
05 


05 


c20601 


DS 
00 


F7 


MNEM 


LD 
LD 
XOR 
ADD 
INC 
DEC 
JP 
OUT 
NOP 


OPER 


HL ,0500 
B,O5 

A 

A, (HL) 
HL 

B 
NZ,0106 
(F7),A 
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The line SECTION (DEMO) in the DI display indicates that the object code being disassembled comes from 
the program section called DEMO. In fact, the entire memory area used by your program (location 0 through 
the end of the table — location 504) belongs to section DEMO. This section was declared by the SECTION 
directive in the source code. 


The LOC (location) column of the DI display contains information that enables you to correlate the display 
with your assembler listing. The symbols START and LOOP in the DI display correspond to the labels 
START and LOOP in the source code. In the display, when a location does not correspond to a label in the 
symbol table, DI substitutes the address of the instruction relative to the beginning of the section, as 
shown in the address field of your assembler listing. If you haven't loaded the pertinent symbols and related 
information into the symbol table (using a command such as SYMLO), the DI command supplies absolute 
(actual) addresses in the LOC column. (Since section DEMO begins at address 0, the relative address, or 
offset, is the same as the absolute address in this display. This offset feature is much more useful for 
sections that don’t start at address 0.) 


Now you've seen that your system can use the symbol table to translate numbers into symbols to make a 
display easier to read. Your system can also translate a symbol in a command line into an address. For 
example, since your system knows that the symbol START is equivalent to the address 100, you could have 
entered the DI command in any of the following ways: 


di 100 10E 

di START 10E 

di start start+0e 
di 100 START+0E 


Notice that a symbol can be entered in either lowercase or uppercase. 


The feature that enables DOS/50 and OS/40 to correlate symbols from your program with the numbers they 
represent is termed symbolic debug. 


Put Values into the Table in Memory. The demonstration program sums five numbers from a table in 
memory. Use the P (Patch) command to place the numbers 1, 2, 3, 4, and 5 in the table. Do you remember 
what the address of the table is? It doesn't matter, as long as you remember that the symbol TABLE 
represents that address. 

> p table 0102030405 <CR> 


4 
address of string of bytes to be stored 
table: 500 at addresses 500 to 504 


Check the Contents of the Table. Use the D command to display the contents of the table. (When you 


don't specify an upper boundary for the area to be dumped, the D command dumps 16 bytes.) 
[occ ceee lower address: 500 


" 
1—--- upper address: omitted 
' ’ (defaults to lower address + OF) 


> d table <CR> 
O 1 2 3 4 5 6 7 8 9 A B C D £E F 
000500 O1 O02 03 04 05 27 EB CF C3 BC EB B6 9D AB AF DB ..wsccccccsceees 
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Notice that bytes 500 to 504 (the table) contain the values you patched in. Bytes 505 to 50F contain random 
data left over from previous system operations. 


The following command dumps only the contents of the table: 


> d table table +tsize-1l <CR> 
0 12 3 4 5 6 7 8 9 A B C D E F 
000500 O1 O02 O03 04 O5 6 ee are 


Start Program Execution 


Now enter the G (Go) command to start program execution at location 100, the transfer address specified by 
the END directive in the source code. (If you followed Case 4: Patch the Program into Memory, you must 
enter G START instead.) 


> & <CR> 
LOC INST MNEM OPER SP F A B C D E H IL Ik IY 
OOO1OF 00 NOP 0000 42 OF OO OO O00 OO 05 O05 0000 O000 


OOO10F 00 <BREAK > 


The program executes, and when the Exit SVC occurs, the program breaks (stops), and the contents of the 
emulator registers are displayed. The accumulator contains the sum of the numbers in the memory table: 
14+24+34+4+45=OF. 


MONITOR PROGRAM EXECUTION 


You have assembled, loaded, and executed the demonstration program. The rest of this demonstration 
shows you some commands for monitoring program execution. You can watch the changes in the emula- 
tor's registers and observe the effect of each instruction as the program proceeds. 


Trace All Instructions. The TRA (TRAce) command lets you observe the changes in the Z80 registers as 
the program proceeds. When you enter a TRA command and then start execution with the G command, 
display lines are sent to the system terminal. As each instruction executes, the display line shows the 
instruction (as in the Dlsassemble display) and the contents of the registers after that instruction has execut- 
ed. Enter the following command to trace all of the program’s instructions: 

> tra all <CR> 


Enter the command G START (or G 100) to resume program execution at the begining of the program: 
> g start <CR> 
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As the program executes, the following trace is displayed. Remember that you can type CTRL-S to suspend 
the display and CTRL-Q to resume the display. 


LOC INST MNEM OPER SP F A B C D E HL Ix I¥ 
SECTION (DEMO) 

START 210005 LD  HL,0500 FFFF 42 OF 00 00 00 00 05 00 0000 0000 
4000103 0605 LD B,O5 FFFF 42 OF 05 00 00 00 05 00 0000 0000 
+000105 AF XOR A FFFF 44 00 05 00 00 00 05 00 0000 0000 
LOOP 86 ADD A, (HL) FFFF 00 01 05 00 00 00 05 00 0000 0000 
+000107 23 INC HL FFFF 00 01 05 00 00 00 05 01 0000 0000 
+000108 05 DEC B FFFF 02 01 04 00 00 00 05 01 0000 0000 
+000109 C20601 JP NZ,0106 FFFF 02 01 04 00 00 00 05 01 0000 0000 
LOOP 86 ADD A,(HL) FFFF 00 03 04 00 00 00 05 01 0000 0000 
+000107 23 INC HL FFFF 00 03 04 00 00 00 05 02 0000 0000 
+000108 05 DEC B FFFF 02 03 03 00 00 00 05 02 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 02 03 03 00 00 00 05 02 0000 0000 
LOOP 86 ADD A,(HL) FFFF 00 06 03 00 00 00 05 02 0000 0000 
+000107 23 INC HL FFFF 00 06 03 00 00 00 05 03 0000 0000 
+000108 05 DEC B FFFF 02 06 02 00 00 00 05 03 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 02 06 02 00 00 00 05 03 0000 0000 
LOOP 86 ADD A, (HL) FFFF 08 OA 02 00 00 00 05 03 0000 0000 
4000107 23 INC HL FFFF 08 OA 02 00 00 00 05 04 0000 0000 
+000108 05 DEC B FFFF 02 0A 01 00 00 00 05 04 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 02 OA 01 00 00 00 05 04 0000 0000 
LOOP 86 ADD A, (HL) FFFF 08 OF 01 00 00 00 05 04 0000 0000 
+000107 23 INC HL FFFF 08 OF 01 00 00 00 05 05 0000 0000 
+000108 05 DEC B FFFF 42 OF 00 00 00 00 05 05 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 42 OF 00 00 00 00 05 05 0000 0000 
LOC INST MNEM OPER SP F A BC D EH OL iIx IY 
+00010C D3F7 OUT (F7),A FFFF 42 OF 00 00 00 00 05 05 0000 0000 
4000100 D3F <BREAK TRACE> 


After the accumulator is cleared, it begins to store the sum of the numbers being added. The ADD A 
instruction adds a number from the table into the accumulator. At the end of the program, the accumulator 
contains the sum of the numbers you put into the table. 


Register B, the pass counter, is set to contain 5 (TSIZE) at the beginning of the program. It decreases by one 
(because of the DEC B instruction) each time a number is added into the accumulator. The program ends 
after register B reaches zero. 


The H-L register pair, set to contain 500 (TABLE) at the start of the program, increases by one each time a 
number is added to the accumulator. At the end of the program, the H-L register pair has been incremented 
five times and contains 505. 


Trace to the Line Printer. By adding the parameter >LPT to a command, you can direct that command’s 
Output to the line printer instead of to the system terminal. First, verify that your line printer is properly 
connected and powered up. Then enter the following command to execute the program with trace output 
directed to the line printer: 

> g start LPT <CR> 


NOTE 
If you're operating in TERM mode with an 8560, use one of the following commands in place of the 
command shown: 
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¢ g start lipir sends the display to the 8560 line printer. 


® g start \>LPT sends the display to the line printer on the 8540 or 8550. 


Trace Jump Instructions Only. Another way to monitor the program’s execution is to look only at the jump 
instructions. By tracing the jump instructions, you can still observe the changes in the registers, but you save 
time and space by not tracing the instructions within the loop. Enter the following command to trace only the 
jump instructions when the loop is being executed: 

> tra jmp loop 109 <CR> 


cs 
!-.-— upper address Within this range, 
only jump instructions 
1------ lower address are traced. 

(106) 


Again, start your program with the G command. The following trace is displayed: 
> g start <CR> 


Loc INST MNEM OPER SP F A BC DEH L Ix IY 
SECTION (DEMO) 

START 210005 LD 4HL,0500 FFFF 42 OF 00 00 00 00 05 00 0000 0000 
+000103 0605 LD  B,O05 FFFF 42 OF 05 00 00 00 05 00 0000 0000 
+000105 AF XOR A FFFF 44 00 05 00 00 00 05 00 0000 0000 
+000109 C20601 JP NZ,0106 FFFF 02 01 04 00 00 00 05 01 0000 0000 
+000109 C20601 JP NZ,0106 FFFF 02 03 03 00 00 00 05 02 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 02 06 02 00 00 00 05 03 0000 0000 
4000109 C20601 JP NZ,0106 FFFF 02 OA 01 00 00 00 05 04 0000 0000 
+00010C D3F7 OUT (F7),A FFFF 42 OF 00 00 00 00 05 05 0000 0000 
4+00010C D3F <BREAK TRACE > 


As with the TRA ALL display, observe that register B (the pass counter) is decremented, the H-L register 
pair (the table pointer) is incremented, and the accumulator stores the sum of the numbers from the table. 
With the TRA JMP selection in effect, the instructions within the loop are not displayed. 


Check the Status of the Trace. The TRA command without any parameters displays the trace conditions 
that are currently set. Because you can have up to three trace selections in effect at the same time, it is 
useful to be able to see which selections are active. Check your trace status with the following command 
line: 

> tra <CR> 


TRACE ALL,OOO0000, OOFFFF 
TRACE JMP,LOOP,000109 


As you've specified, TRA ALL is in effect for aadresses 0 to 105, TRA JMP is in effect for addresses 106 to 
109, and TRA ALL is again in effect for addresses 10A to FFFF. 
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Set a Breakpoint after a Specific Instruction. Now that you’ve seen how the program adds the numbers 
together, here’s a new task: to add only the third and fourth numbers from the table. To perform this task, 
you want the pass counter to contain 2, and the table pointer to contain 502 (the address of the third number 
in the table). You can accomplish these changes without altering the object code in memory. First, stop 
program execution after the pass counter and the table pointer have been set. Next, while the program is 
stopped, enter new values for the pass counter and table pointer. When execution resumes, the program 
treats the new values as if they were the original programmed value. 


Enter the following command line to trace all of the instructions as the program executes: 
> tra aii <CR> 


Check the status of the trace with the following command line: 


> tra <CR> 
TRACE ALL,OOO000, OOFFFF 


The TRA ALL command just entered makes the earlier TRA selections obsolete. 


Now you set a breakpoint so that the program stops after the table pointer and pass counter have been set. 
The following command causes the program to stop after it executes the LD B instruction at address 103: 
> bk 1 103 <CR> 


le---- breakpoint address 


ouesaece breakpoint number 
(can be 1 or 2) 


Use the G command to start program execution: 


> g start <CR> 

Loc INST MNEM OPER SP F A B C D E H UL IX IY 
SECTION (DEMO) 

START 210005 LD HL,0O500 FFFF 42 OF 00 00 00 00 O05 00 0000 0000 
+000103 0605 LD B,0O5 FFFF 42 OF 05 00 00 00 O05 OO 0000 0000 
+000103 O60 <BREAK TRACE, BKPT1 > 


The TRA ALL command enabled display of all instructions up to and including the instruction at the 
breakpoint. 


Set New Values in Pass Counter and Table Pointer; Check Results. Now that you've reached the break- 
point, you can change the contents of the registers while execution is stopped. The break display shows that 
register B (the pass counter) contains 5, and the H-L register pair (the table pointer) contains the address 
500. Use the S (Set) command to set the number of passes to two and set the table pointer to 502: 

> ¢ BS2<L=2 <cR> 
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The S command does not produce a display, but you can use the DS (Display Status) command to check the 
values in the registers you changed. DS displays the contents of each emulator register and status flag. 
Check the result of the previous S command with the following command line: 


> ds <CR> 
PC=0105 SP=FFFF F=42 A=OF B=02 C=00 D=00 E=00 H=05 L=02 
IX=0000 IY=0000 AF=00 AA=00 AB=00 AC=00 AD=00 AE=00 AH=00 AL=00 


IFF1=0 IFF2=0 IM=O I=00 R=37 


The DS display shows that the nass counter an 
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vy contain the new values. 


Resume Program Execution. If you enter the G command with no parameters, program execution starts 
where it left off. Resume program execution after the breakpoint with the following command: 


> g <CR> 

Loc. INST MNEM OPER SP F AB COD EH UL #iIx MIy 
SECTION (DEMO) 

+000105 AF XOR A FFFF 44 00 02 00 00 00 05 02 0000 0000 
LOOP 86 ADD A, (HL) FFFF 00 03 02 00 00 00 05 02 0000 0000 
+000107 23 INC HL FFFF 00 03 02 00 00 00 05 03 0000 0000 
+000108 05 DEC B FFFF 02 03 01 00 00 00 05 03 0000 0000 
+000109 C20601 JP NzZ,0106 FFFF 02 03 01 00 00 00 05 03 0000 0000 
LOOP 86 ADD A, (HL) FFFF 00 07 01 00 00 00 05 03 0000 0000 
+000107 23 INC HL FFFF 00 07 01 00 00 00 05 04 0000 0000 
+000108 05 DEC B FFFF 42 07 00 00 00 00 05 04 0000 0000 
+000109 C20601 JP NZ,0106 FFFF 42 07 00 00 00 00 05 04 0000 0000 
+00010C D3F7 OUT (FT7),A FFFF 42 07 00 00 00 00 05 04 0000 0000 
+00010C D3F <BREAK TRACE> 


Notice that the program performed two passes through the loop, and that the program added the third and 
fourth numbers in the table: 3+4=7. 


Delete the Demonstration Run Files 


Now that you've finishd the demonstration run, you can delete the source file, object file, listing file, and load 
file. If you're using an 8550, the source and load files are still available to you on the Z80 emulator installation 
disk. If you’re using an 8560, remember that once you delete the source file (asm) , there is no way of 
recovering it. 


Delete 8550 Files. if your files are on the 8550, use the following procedure to delete them. First use the 
USER command to move from the DEMO directory back in to the directory you were in at the start of the 
demonstration. Recall that you marked that directory with the brief name /ROOT. 

> USER /ROOT <CR> 


Now enter the following command to delete the DEMO directory and the files it contains: 
> DEL DEMO/* DEMO <CR> 


Delete ASM ? Y <CR> 
Delete LOAD ? Y¥ <CR> 
Delete OBJ ? Y <CR> 
Delete ASML ? Y <CR> 
Delete DEMO ? Y¥ <CR> 
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Before deleting each file, DOS/50 asks you whether you really want to delete it. You type Y for yes. 


Delete 8560 Files. If your files are on the 8560, use the following procedure to delete them. Enter the 
following command to remove all files in the working directory, including the source file: 
$ rm * <CR> 


Now move from the demo directory back into the parent directory and remove the demo directory itself: 


$ es .. <CR> 
$ rmdir demo <CR> 


Turn Off Your System 


For instructions on turning off your 8540 or 8550, refer to the Learning Guide of your System Users Manual. 


SUMMARY OF Z80 EMULATOR DEMONSTRATION RUN 


You have assembled, loaded, executed, and monitored the demonstration run program. You have used the 
following commands: 


e SEL — selects the Z80 assembler and emulator 

¢ ASM — creates object code from an assembly language program 
e LINK — links object code into a load module 

e F — fills an area of memory with a specified value 

¢ D — displays memory contents in ASCII and hexadecimal format 
e LO — loads object code into memory 

e SYMLO — loads program symbols for use in symbolic debug 

¢ DI — translates memory contents into assembly language mnemonics 
¢ P — patches a string of bytes into memory 

e SYMD — turns on symbolic debug displays 

¢ G — begins or resumes program execution 

¢ TRA — selects instructions to be traced during program execution 
e BK — sets a breakpoint 

¢ S— modifies emulator registers 


¢ DS — displays emulator registers 
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